package com.xxy.partnermatch.service;

import com.baomidou.mybatisplus.extension.service.IService;
import com.xxy.partnermatch.model.dto.UserRegisterRequest;
import com.xxy.partnermatch.model.entity.User;
import com.xxy.partnermatch.model.vo.UserVO;
import jakarta.servlet.http.HttpServletRequest;

import java.util.List;

/**
 * @author TX
 * @description 针对表【user】的数据库操作Service
 * @createDate 2024-11-14 15:12:54
 */
public interface UserService extends IService<User> {

    /**
     * 用户注册
     *
     * @param userRegisterRequest 用户注册请求体
     * @return 新用户id
     */
    long userRegister(UserRegisterRequest userRegisterRequest);

    /**
     * 用户登录
     *
     * @param userAccount  用户账号
     * @param userPassword 用户密码
     * @param request      request请求对象
     * @return 当前登录用户
     */
    UserVO userLogin(String userAccount, String userPassword, HttpServletRequest request);

    /**
     * 用户注销
     *
     * @param request request请求对象
     * @return 返回值大于0表示注销成功
     */
    int userLogout(HttpServletRequest request);

    /**
     * 获取当前登录用户
     *
     * @param request request请求对象
     * @return 当前登录用户
     */
    UserVO getCurrentUser(HttpServletRequest request);

    /**
     * 根据id删除用户
     *
     * @param id      删除用户id
     * @param request request请求对象
     * @return 返回值大于0表示删除成功
     */
    int deleteUser(long id, HttpServletRequest request);

    /**
     * 根据用户名查找用户 (仅管理员可查询)
     *
     * @param username 用户名
     * @param request  request请求对象
     * @return 符合要求的用户集合
     */
    List<UserVO> searchUsers(String username, HttpServletRequest request);

    /**
     * 根据标签搜索用户
     *
     * @param tagNameList 标签列表
     * @return 用户列表
     */
    List<UserVO> searchUserVOByTags(List<String> tagNameList);

    /**
     * 获取当前登录用户
     *
     * @param request request请求对象
     * @return 当前登录用户
     */
    UserVO getLoginUser(HttpServletRequest request);

    /**
     * 更新用户
     *
     * @param user      更新用户信息
     * @param loginUser 当前登录用户
     * @return 是否更新成功
     */
    int updateUser(User user, UserVO loginUser);

    /**
     * 是否为管理员
     *
     * @param request request请求对象
     * @return 是否管理员
     */
    boolean isAdmin(HttpServletRequest request);

    /**
     * 是否为管理员
     *
     * @param loginUser 当前登录用户
     * @return 是否管理员
     */
    boolean isAdmin(UserVO loginUser);

    /**
     * 获取匹配用户
     *
     * @param num       匹配用户数量
     * @param loginUser 当前登录用户
     * @return 用户列表
     */
    List<UserVO> matchUsers(long num, UserVO loginUser);
}
